home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / PROGRAMM / BASIC / 0006.ZIP / FU.DOC < prev    next >
Text File  |  1982-05-03  |  7KB  |  169 lines
  1. FU.COM is a command which will allow you to manipulate PC files much like the   
  2. FLIST command of VM.  After invoking the FU command, it becomes part of the
  3. DOS operating system.  This fact is indicated by the 'large' cursor which
  4. will be present when you are being prompted from DOS.  
  5.  
  6. FU provides a full screen list of a file set specified by the user.  These
  7. may be presented in name, extension, date, or size order, and the order of
  8. presentation may be changed dynamically.  Beside each entry is displayed an
  9. area to allow the entry of commands.  In display mode, the editing keys and
  10. function keys may be used to page through the list and add or delete
  11. commands.  When the execution mode is entered, the commands are passed to the
  12. command environment for execution; commands are returned to the command
  13. environment, one after the other.  When all commands have been executed, the
  14. DOS prompt appears, with a full block cursor.  Entry of a null command (I.e.
  15. return) will redisplay the file list.  Any other entry will be immediately
  16. executed by DOS.
  17.  
  18. The program becomes a resident extension of DOS.  It occupies approximately
  19. 6K bytes of storage.  At present, DOS must be IPLed to remove the resident
  20. extension.
  21.  
  22. INVOKING FULIST
  23.  
  24. FU  < fspec > < /sn | /se | /sd | /ss >
  25.  
  26. where - fspec is of the form d:name.ext.  If omitted it defaults to all files
  27.          on the default disk.  If the /sx is omitted, the display is in date
  28.          sequence.
  29.  
  30. FU is invoked from the DOS command environment by issuing the command shown
  31. above.  If the filespec is omitted, all files on the current default disk
  32. will be listed.  If /sx is omitted, the files will be sorted by date.
  33.  
  34. SCREEN FORMAT
  35.  
  36. The displayed screen consists of three distinct areas.  The first line is a
  37. status line.  The first two characters are the DOS prompt currently active. 
  38. The balance of the line gives the free space on the listed diskette plus the
  39. number of the first displayed entry as well as the count of active
  40. (displayed) entries.
  41.  
  42. The next 23 lines contain display entries for listed files.  The first 20
  43. positions are a command area.  The balance of the line contains the drive,
  44. name, and extension for the file, followed by the date and size of the file
  45. in hex.  Lastly, the attributes of the file are displayed.
  46.  
  47. The last line of the screen displays the PF key settings.
  48.  
  49. MANIPULATING THE DISPLAY
  50.  
  51. Once the list is displayed, the editing keys on the keyboard may be used to
  52. manipulate the screen.  The semantics for the key usage follow those used for
  53. the BASIC editor.  They are:
  54.  
  55. PGUP       move the display to show entries near the beginning of the
  56.            entry sequence.
  57.  
  58. CTL-PGUP   move the display to show the first screen of entries in the entry
  59.            sequence.
  60.  
  61. PGDN       move the display to show the last screen of entries in the entry
  62.            sequence.
  63.  
  64. CTL-PGDN   move the display to show the last screen of entries in the entry
  65.            sequence.
  66.  
  67. HOME       Position the cursor to the first position of the command area on 
  68.            the first entry displayed on the screen.
  69.  
  70. END        position the cursor to the last character in the command field.
  71.  
  72. CTL-END    erase the command area from the cursor to the end of the field.
  73.  
  74. INS        toggle insert mode.  When in insert mode, a full block cursor is
  75.            displayed.
  76.  
  77. DEL        delete the character at the cursor.
  78.  
  79. Cursor keys  move the cursor in the directions depicted by the arrows.
  80.  
  81. ENTER      positions the cursor to the beginning of the next command area.
  82.  
  83. backspace  deletes the character to the left of the cursor.
  84.  
  85. TAB        skips to the first position of the next command area.
  86.  
  87. up-tab     skips backward to the beginning of the previous command field.  
  88.            If the cursor is not in the first position of the command area,
  89.            this key will position to the first position of the current 
  90.            command area.
  91.  
  92. CTL-return enter the execution mode.
  93.  
  94. PROGRAM FUNCTION KEYS
  95.  
  96. The functions provided on the PF keys are displayed on the 25th line of the
  97. display.  No provision is currently provided for modifying these assignments. 
  98. They are set in a table in character string form, so those who are
  99. knowledgeable in the use of DEBUG could reassign them.  A possible future
  100. extension is to allow user setting via a command or profile or both.  The
  101. assignment is similar to the BASIC softkeys, with the PF key placing the
  102. assigned character string on the command line at the first position.  If the
  103. last character of the string is the ascii for an Esc character, the
  104. character is not moved to the command line, but the execution mode is
  105. entered.
  106.  
  107. INTERNAL FULIST FUNCTIONS
  108.  
  109. Certain functions which refresh and reorder the displayed entries are
  110. available.  They are:
  111.  
  112. /B       Display the last (bottom) page for this level.
  113.  
  114. /R fspec Replace the current display with the display for the specified file
  115.          specification.  If fspec is omitted the currently displayed file
  116.          spec will be refreshed.  The sort order for the refreshed display
  117.          will be the same as that of the currently displayed list.
  118.  
  119. /O       Omit appending the file spec at the end of the command line.
  120.  
  121. /Sx      Sort the level on specified field(s).  After sorting, the level is
  122.          redisplayed from the top.  Sorting can be performed on the following
  123.          fields:
  124.  
  125.           /SN - name ext        ascending
  126.           /SE - ext  name       ascending
  127.           /SD - date  name ext  descending
  128.           /SS - size  name ext  descending
  129.  
  130. /T       Display the first (top) page for this level.
  131.  
  132. /X       Exclude this entry from the list.  The entry will no longer be 
  133.          shown.
  134.  
  135. /<nnn>   position file nnnn as the top line on the screen.  If nnnn is 
  136.          omitted, the line which contains the / is positioned as the top 
  137.          line.
  138.  
  139. =        repeat the last external command executed.  FULIST functions are not 
  140.          considered to be commands in this respect and thus cannot be
  141.          repeated.
  142.  
  143. ?        Display the last external command executed.  To execute the command, 
  144.          at least one character has to be retyped.
  145.  
  146. USING THE INPUT AREA
  147.  
  148. The input areas after the fileids may be used to enter any command as in the
  149. normal DOS environment.  If not explicitly specified, FULIST will put the
  150. filespec at the end of the command line, unless the command is preceded by
  151. the /O internal command.  If the fileid (or parts of it) are to be inserted
  152. at a different place in the command line, the special indicator / may be
  153. used.  It may be used anywhere in the command sequence, as follows:
  154.  
  155. /       insert the complete fileid
  156.  
  157. /d      insert the drive id (d:)
  158.  
  159. /n      insert the file name
  160.  
  161. /e      insert the file extension
  162.  
  163. Any combination of d, n, and e is valid.  To prevent any part of the fileid
  164. from being used in the command sequence the /O function may be used as the
  165. first parameter,  When all input fields are processed, the DOS prompt will be
  166. displayed, with a full block cursor.  If a null command is issued, the screen
  167. is redisplayed.
  168.  
  169.